Spread Windows Forms 7.0 Product Documentation
SetConditionalFormatting(Int32,Int32,Int32,Int32,Boolean,IConditionalFormattingRule[]) Method
See Also  Example Support Options
FarPoint.Win.Spread Assembly > FarPoint.Win.Spread Namespace > SheetView Class > SetConditionalFormatting Method : SetConditionalFormatting(Int32,Int32,Int32,Int32,Boolean,IConditionalFormattingRule[]) Method


row
Starting row index
column
Starting column index
rowCount
Number of rows
columnCount
Number of columns
isCombinable
Indicates that rule(s) can be merged into an existing conditional formatting if they affect the same cell range(s).
rules
Rules to apply for the specified range of cells

Glossary Item Box

Sets conditional formatting for a specified range of cells on the sheet based on specified rules.

Syntax

Visual Basic (Declaration) 
Public Overloads Sub SetConditionalFormatting( _
   ByVal row As Integer, _
   ByVal column As Integer, _
   ByVal rowCount As Integer, _
   ByVal columnCount As Integer, _
   ByVal isCombinable As Boolean, _
   ByVal ParamArray rules() As IConditionalFormattingRule _
) 
Visual Basic (Usage)Copy Code
Dim instance As SheetView
Dim row As Integer
Dim column As Integer
Dim rowCount As Integer
Dim columnCount As Integer
Dim isCombinable As Boolean
Dim rules() As IConditionalFormattingRule
 
instance.SetConditionalFormatting(row, column, rowCount, columnCount, isCombinable, rules)
C# 
public void SetConditionalFormatting( 
   int row,
   int column,
   int rowCount,
   int columnCount,
   bool isCombinable,
   params IConditionalFormattingRule[] rules
)

Parameters

row
Starting row index
column
Starting column index
rowCount
Number of rows
columnCount
Number of columns
isCombinable
Indicates that rule(s) can be merged into an existing conditional formatting if they affect the same cell range(s).
rules
Rules to apply for the specified range of cells

Example

This example creates a conditional rule.
C#Copy Code
private void Form1_Load(object sender, EventArgs e)
        {
            fpSpread1.Sheets[0].Cells[0, 0].Value = 3;
            fpSpread1.Sheets[0].Cells[1, 0].Value = 2;
            fpSpread1.Sheets[0].Cells[1, 1].Value = 10;
            fpSpread1.Sheets[0].Cells[0, 2].Value = 1;            
        }

        private void button1_Click(object sender, EventArgs e)
        {
            FarPoint.Win.Spread.UnaryComparisonConditionalFormattingRule unary = new FarPoint.Win.Spread.UnaryComparisonConditionalFormattingRule(FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo, 10, false);
            unary.Operator = FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo;
            unary.Value = 10;
            unary.BackColor = Color.Red;
            unary.FontStyle = new FarPoint.Win.Spread.SpreadFontStyle(RegularBoldItalicFontStyle.Bold);            
     
            FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule between = new FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(true, 10, false, 20, false);
            between.FirstValue = 1;
            between.SecondValue = 20;
            between.IsNotBetween = true;
            between.BackColor = Color.Bisque;
                        
            //SetConditionalFormatting Overload
            fpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, false, unary, between);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { new FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), new FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1) }, unary, between);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { new FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), new FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1) }, false, unary);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, unary);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, false, unary);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, unary, between);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, false, unary);
        }
VB.NETCopy Code
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        FpSpread1.Sheets(0).Cells(0, 0).Value = 3
        FpSpread1.Sheets(0).Cells(1, 0).Value = 2
        FpSpread1.Sheets(0).Cells(1, 1).Value = 10
        FpSpread1.Sheets(0).Cells(0, 2).Value = 1
    End Sub

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
        Dim unary As New FarPoint.Win.Spread.UnaryComparisonConditionalFormattingRule(FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo, 10, False)
        unary.Operator = FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo
        unary.Value = 10
        unary.BackColor = Color.Red
        unary.FontStyle = New FarPoint.Win.Spread.SpreadFontStyle(RegularBoldItalicFontStyle.Bold)

        Dim between As New FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(True, 10, False, 20, False)
        between.FirstValue = 1
        between.SecondValue = 20
        between.IsNotBetween = True
        between.BackColor = Color.Bisque

        'SetConditionalFormatting Overload
        FpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, False, unary, between)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {New FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), New FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1)}, unary, between)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {New FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), New FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1)}, False, unary)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, unary)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, False, unary)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, unary, between)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, False, unary)
    End Sub

Requirements

Target Platforms: Windows 2000 Professional (SP4), Windows 2000 Server, Windows 2003 Server (SP1), Windows 2008, Windows XP (SP2), Windows Vista, Windows 7, Windows 8

See Also

© 2002-2014 ComponentOne, a division of GrapeCity. All Rights Reserved.